chore(capture): document capture_mode + release changeset (capture v1, 6/6)#706
Draft
eli-r-ph wants to merge 1 commit into
Draft
chore(capture): document capture_mode + release changeset (capture v1, 6/6)#706eli-r-ph wants to merge 1 commit into
eli-r-ph wants to merge 1 commit into
Conversation
Contributor
|
Reviews (1): Last reviewed commit: "docs(capture): document capture_mode and..." | Re-trigger Greptile |
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
Contributor
posthog-python Compliance ReportDate: 2026-06-28 00:52:02 UTC ✅ All Tests Passed!110/110 tests passed Capture_V1 Tests✅ 94/94 tests passed View Details
Feature_Flags Tests✅ 16/16 tests passed View Details
|
eli-r-ph
force-pushed
the
capture-v1/06-docs
branch
from
171fdd0 to
4604596
Compare
eli-r-ph
force-pushed
the
capture-v1/05-harness-ci
branch
2 times, most recently
from
6db84db to
241364f
Compare
eli-r-ph
force-pushed
the
capture-v1/06-docs
branch
2 times, most recently
from
4615a22 to
57eef07
Compare
eli-r-ph
force-pushed
the
capture-v1/05-harness-ci
branch
from
241364f to
292e391
Compare
Adds the Sampo changeset for the opt-in capture_mode (v1 ingestion protocol) and capture_compression, plus an AGENTS.md section mapping capture_mode/capture_compression and their env vars to the modules and routing that implement them, the v1 invariants to preserve, and the sync_mode blocking-retry behavior. User-facing usage stays in the official docs per the README convention.
eli-r-ph
force-pushed
the
capture-v1/05-harness-ci
branch
from
292e391 to
79dc48f
Compare
eli-r-ph
force-pushed
the
capture-v1/06-docs
branch
from
57eef07 to
65d724c
Compare
eli-r-ph
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
💡 Motivation and Context
Final PR in the stacked Capture V1 series (stacked on #705). Documents the new opt-in
capture_modeso the feature ships with release notes and in-repo guidance..sampo/changesets/capture-v1-mode.md,minor) — describes the newcapture_mode/POSTHOG_CAPTURE_MODEopt-in for the next release. CHANGELOG.md is generated bysampo release, so the changeset is the right place to add this (not a manual CHANGELOG edit).capture_mode)" section mapping the modes to the modules and routing that implement them (capture_mode.py,capture_v1.py,Consumer._send_analytics/Client._enqueue), plus the v1 invariants to preserve when editing (sentinel lifting + coerce-or-omit,$set/$set_oncerelocation, partial retry with stable request id, 429 terminal).User-facing usage examples intentionally stay in the official docs — the README explicitly defers to them ("SDK usage examples and code snippets live in the official documentation so they stay up to date"), so this PR adds developer-facing notes rather than README usage.
💚 How did you test it?
Docs/changeset only — no runtime code.
import posthogsmoke check passes;from posthog import CaptureModeresolves. The changeset format matches the existing.sampo/changesets/*.mdconvention.📝 Checklist
🤖 Agent context
Autonomy: Human-driven (agent-assisted)
Authored with Cursor (Claude Opus 4.8) per the agreed plan. Final PR of the 6-part stack (#701 -> #706): config scaffolding, transforms, transport, wiring, compliance adapter/CI, and these docs.